chore: update project memories with latest codebase state(1.8.0) by imbajin · Pull Request #2998 · apache/hugegraph

imbajin · 2026-04-18T20:38:06Z

Purpose of the PR

Keep the project's memory clean & useful

- Refresh all 8 memories to reflect current code (v1.7.0) - Remove all PR number references (derivable from git history) - Remove "Key Recent Changes" changelog section - Remove CI implementation details (rerun delay/count) - Describe current behavior as facts, not change events - Mark legacy backends as excluded from Serena context - Add GraphSpace, Swagger UI, TTL update, bridge networking info chore: add .mcp.json to .gitignore fix: keep .serena/memories/ and project.yml tracked in git

Copilot

Pull request overview

Updates repository “project memories” / Serena configuration to reflect the current HugeGraph codebase and CI layout, plus refreshes README CI badges.

Changes:

Update README badges to reflect current GitHub Actions workflows.
Expand .serena/project.yml with richer ignore patterns and newer Serena config options.
Rewrite/condense multiple .serena/memories/*.md documents (commands, module map, conventions, architecture, ecosystem).

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
`README.md`	Updates CI badges to point at `server-ci.yml` and `pd-store-ci.yml`.
`.serena/project.yml`	Updates Serena project config: language list comments, ignore paths, and new config keys.
`.serena/memories/task_completion_checklist.md`	Condenses checklist into a shorter “quality/tests/deps/CI/commit” format.
`.serena/memories/suggested_commands.md`	Reorganizes common build/test/validation/docker commands into a shorter reference.
`.serena/memories/project_overview.md`	Refreshes high-level project description, capabilities, and version summary.
`.serena/memories/key_file_locations.md`	Updates “map” of important directories and CI workflows.
`.serena/memories/implementation_patterns_and_guidelines.md`	Updates implementation notes (backends, GraphSpace, auth, CI, docker).
`.serena/memories/ecosystem_and_related_projects.md`	Rewrites ecosystem overview into a compact table + integration summary.
`.serena/memories/code_style_and_conventions.md`	Condenses style/convention notes and points to key enforcement tools.
`.serena/memories/architecture_and_modules.md`	Simplifies architecture + module structure summary.
`.gitignore`	Stops ignoring all of `.serena/` wholesale; keeps `project.yml` and `memories/` tracked while ignoring other `.serena/*`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Remove content duplicated in README.md (project overview, architecture, module tables, code style, CI profiles). Focus test examples on active backends (RocksDB/memory) only. Strip hardcoded version numbers. Keep unique development workflows (dependency compliance, gRPC, auth, debugging). 262 lines → 120 lines (54% reduction, zero duplication). refactor(docs): remove non-development sections from AGENTS.md Remove debugging tips (ops tools), authentication system description, Docker Compose references, and ecosystem section. 120 → 103 lines.

- Remove leading blank lines in project.yml (#6) - Clarify bin/ script path in suggested_commands.md (#4) - Fix Docker cluster command missing cd prefix (#5) - Add HStore to pd-store-ci.yml description (#7) - Split editorconfig/checkstyle into separate commands (#2)

VGalaxies

Review findings from local audit.

VGalaxies · 2026-04-19T15:18:39Z

+ignored_paths:
+  # --- Deprecated backends (focus on RocksDB/HStore only) ---
+  - "hugegraph-server/hugegraph-cassandra/**"
+  - "hugegraph-server/hugegraph-scylladb/**"
+  - "hugegraph-server/hugegraph-mysql/**"
+  - "hugegraph-server/hugegraph-postgresql/**"
+  - "hugegraph-server/hugegraph-palo/**"
+  - "hugegraph-server/hugegraph-hbase/**"
+  # --- gRPC generated Java (235k lines, never hand-edited, regenerated by mvn compile) ---
+  - "hugegraph-pd/hg-pd-grpc/src/main/java/**"
+  - "hugegraph-store/hg-store-grpc/src/main/java/**"
+  # --- License/legal files (585 txt files, only touched when adding dependencies) ---
+  - "install-dist/release-docs/licenses/**"
+  - "install-dist/scripts/dependency/known-dependencies.txt"
+  # --- Rarely modified tests/examples ---
+  - "hugegraph-server/hugegraph-test/**/tinkerpop/**"
+  - "hugegraph-server/hugegraph-example/**"
+  - "hugegraph-cluster-test/**"


This ignore list now removes HBase, cluster tests, and the dependency-compliance paths from Serena's project view. That is broader than 'dead/generated code': the repo still ships hugegraph-hbase, still runs hbase in server CI, still contains hugegraph-cluster-test, and AGENTS.md explicitly requires updating the license and known-dependencies.txt files when adding third-party dependencies. With this config, Serena-based agents will miss or be unable to complete those tasks.

This ignore list now removes HBase, cluster tests, and the dependency-compliance paths from Serena's project view. That is broader than 'dead/generated code': the repo still ships hugegraph-hbase, still runs hbase in server CI, still contains hugegraph-cluster-test, and AGENTS.md explicitly requires updating the license and known-dependencies.txt files when adding third-party dependencies. With this config, Serena-based agents will miss or be unable to complete those tasks.

Yes, no need to add HBase related files as the context in the future work (from 1.8.0)

And the memory system(like serena) should focus on the main files (shouldn't include deps/license file) even they might change

VGalaxies · 2026-04-19T15:18:39Z

+## Key Architectural Patterns

-Apache HugeGraph is a fast-speed and highly-scalable graph database that supports billions of vertices and edges. It is compliant with Apache TinkerPop 3 and supports both Gremlin and Cypher query languages.
+1. **Pluggable Backend Architecture**: Storage backends implement the `BackendStore` interface — new backends require no core changes. Active backends: RocksDB (default/embedded), HStore (distributed)


The condensed guide now presents RocksDB/HStore as the only active backends, which conflicts with the current tree: hugegraph-hbase is still a server module and server-ci.yml still tests the hbase backend. Agents following this summary will route HBase work away as unsupported/legacy, which is not the current project state.

The condensed guide now presents RocksDB/HStore as the only active backends, which conflicts with the current tree: hugegraph-hbase is still a server module and server-ci.yml still tests the hbase backend. Agents following this summary will route HBase work away as unsupported/legacy, which is not the current project state.

Same reason, focus on the main/core backend

… docs - Add Development Conventions section: require test coverage for all code changes - Expand Code Quality section with pre-commit checklist and .editorconfig summary - Add Reference Documents section pointing to README and .serena/memories - Link hugegraph-pd/store module names to their READMEs in root README Update .gitignore

VGalaxies · 2026-05-06T13:49:19Z

-# Use Maven's -Dtest parameter
-mvn test -pl hugegraph-server/hugegraph-test -am -P core-test,memory -Dtest=YourTestClass
+mvn install -pl hugegraph-struct -am -DskipTests
+mvn test -pl hugegraph-pd/hg-pd-test -am      # or hg-store-test


Can we spell out the Store test command here instead of relying on # or hg-store-test? Agents will likely copy the line literally, so adding mvn test -pl hugegraph-store/hg-store-test -am would make PD/Store coverage unambiguous.

codecov · 2026-05-06T13:49:46Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 36.08%. Comparing base (9336b5e) to head (58a8944).
⚠️ Report is 7 commits behind head on master.

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #2998      +/-   ##
============================================
+ Coverage     35.65%   36.08%   +0.42%     
- Complexity      333      403      +70     
============================================
  Files           802      811       +9     
  Lines         67731    68219     +488     
  Branches       8844     8904      +60     
============================================
+ Hits          24147    24614     +467     
+ Misses        40995    40986       -9     
- Partials       2589     2619      +30

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@VGalaxies

- Restore architecture diagram, top-level module map, server submodule list, code search anchors, and commit format so AGENTS.md is self-sufficient as the default AI context file - Drop low-entropy sections: "Development Conventions" platitude, single-line gRPC heading, duplicated script listing - Spell out both PD and Store test commands instead of relying on a "# or hg-store-test" comment (per @VGalaxies review) - Remove hbase swap option in the Core test row for consistency with the "focus on core backend" stance

lokidundun and others added 4 commits April 18, 2026 17:56

fix: fix wrong image address

5767236

Update README.md

ccfe8b2

Update README.md

f32950d

Copilot AI review requested due to automatic review settings April 18, 2026 20:38

dosubot Bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Apr 18, 2026

Copilot started reviewing on behalf of imbajin April 18, 2026 20:38 View session

imbajin added 2 commits April 19, 2026 04:39

style: add final newline to Serena memory files

e1af2e0

Merge branch 'master' into update-memory

8f1d1cf

Copilot AI reviewed Apr 18, 2026

View reviewed changes

dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. and removed size:XL This PR changes 500-999 lines, ignoring generated files. labels Apr 18, 2026

imbajin requested a review from VGalaxies April 18, 2026 21:06

VGalaxies reviewed Apr 19, 2026

View reviewed changes

imbajin added 2 commits April 19, 2026 23:36

Update AGENTS.md

bba7ae9

imbajin force-pushed the update-memory branch from 00d2050 to b01e5b9 Compare April 20, 2026 14:02

Update AGENTS.md

c8ecb0c

imbajin force-pushed the update-memory branch from f7006f7 to c8ecb0c Compare May 6, 2026 13:33

VGalaxies reviewed May 6, 2026

View reviewed changes

VGalaxies approved these changes May 7, 2026

View reviewed changes

imbajin merged commit 06c52e4 into master May 7, 2026
15 checks passed

imbajin deleted the update-memory branch May 7, 2026 08:32

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore: update project memories with latest codebase state(1.8.0)#2998

chore: update project memories with latest codebase state(1.8.0)#2998
imbajin merged 12 commits intomasterfrom
update-memory

imbajin commented Apr 18, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VGalaxies left a comment

Uh oh!

VGalaxies Apr 19, 2026 •

edited

Loading

Uh oh!

imbajin Apr 19, 2026

Uh oh!

VGalaxies Apr 19, 2026 •

edited

Loading

Uh oh!

imbajin Apr 19, 2026

Uh oh!

Uh oh!

VGalaxies May 6, 2026

Uh oh!

codecov Bot commented May 6, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

imbajin commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose of the PR

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VGalaxies left a comment

Choose a reason for hiding this comment

Uh oh!

VGalaxies Apr 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

imbajin Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

VGalaxies Apr 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

imbajin Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

VGalaxies May 6, 2026

Choose a reason for hiding this comment

Uh oh!

codecov Bot commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

imbajin commented Apr 18, 2026 •

edited

Loading

VGalaxies Apr 19, 2026 •

edited

Loading

VGalaxies Apr 19, 2026 •

edited

Loading

codecov Bot commented May 6, 2026 •

edited

Loading